home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 1 / Cream of the Crop 1.iso / PRINTER / PNTRCODE.ARJ / PNTRCODE.DOC < prev   
Text File  |  1992-08-16  |  7KB  |  140 lines
  1.                           PNTRCODE.DOC
  2.  
  3. Requirements:   PNTRCODE has been checked with DOS 3.2, 3.3 and
  4. 5.0.  It should probably work with DOS 2.0 or newer but all have
  5. not been checked.  A color display is required.  It is not known
  6. if PNTRCODE will run with a B&W display.
  7.  
  8.                             ********
  9.  
  10.      PNTRCODE, a user friendly printer code sequence generator,
  11. was developed primarily for the owner of a new printer,  be it a
  12. dot matrix, ink-jet or laser.  The owner reads the manual and
  13. soon discovers that specific code sequences must be sent to the
  14. printer to select certain features such as margins, fonts, form
  15. feed, etc.  And to further complicate the matter, most of the
  16. codes require an "escape" character (i.e. - 1B hex or 027
  17. decimal) which is not the easiest character to output to the
  18. printer.
  19.  
  20.      It should be mentioned that as the new printer owner becomes
  21. more experienced, he will utilize software that through set-up
  22. procedures will automatically transmit the proper code sequences
  23. to the printer.  In addition, there are many "pop-up" menu
  24. programs available for the more common printers.  However, for
  25. checkout and for familiarization of a new printer, an easy method
  26. of selecting printer functions would be helpful.
  27.  
  28.      PNTRCODE was designed for this scenario.  PNTRCODE will
  29. prompt the operator for the desired sequence codes.  The output
  30. of PNTRCODE is a "_.COM" file that can be called up as a stand
  31. alone command from DOS (after the DOS prompt) or as a command in
  32. a Batch file.  The "_.COM" file, when run, will send the selected
  33. code sequence to the LPT1 (or PRN) port and thus to the printer.
  34.  
  35.      Use of PNTRCODE is best illustrated with an example. 
  36. Suppose it is desired to set up an EPSON dot-matrix printer to
  37. print an ASCII file with a left margin of 5 spaces.  Checking the
  38. EPSON manual shows that a code sequence must be sent to the
  39. printer that contains the following codes:
  40.  
  41.      ASCII Characters        ESCAPE     l      5
  42.      Decimal                   27      108     53
  43.  
  44.      Insure that both PNTRCODE files (CODEGEN.EXE and
  45. PNTRCODE.BAT) are located in the DOS directory that includes the
  46. DOS file DEBUG.EXE (or DEBUG.COM if appropriate) file or that the
  47. path statement includes a path to the DOS directory and DEBUG. 
  48. Call up PNTRCODE from the DOS command line (after the DOS prompt)
  49. by typing "PNTRCODE" (without the quotes) followed by pressing
  50. the enter key (<ENTER> will be used here to indicate that the
  51. "ENTER" key should be pressed).  A menu box will appear that
  52. prompts for a name for the to-be-generated "_.COM" file.  Only 8
  53. alphanumeric characters are permitted.  For this example an
  54. appropriate filename "LEFTMARG" could be typed, followed by
  55. <ENTER>.  Additional information will appear on the menu and the
  56. program will prompt for the first code.  For this example, the
  57. first code is "ESCAPE" and this can be selected in one of 2 ways. 
  58.  
  59.  
  60. The operator may press the "ESCAPE" key and then <ENTER>.  The
  61. display will indicate that ESCAPE (shown as ESC) has been
  62. selected, and in addition will show that "ESCAPE" has a hex code
  63. of "1B" and an ASCII decimal code of "27".  The "ESCAPE" code can
  64. also be selected by typing "27" (without quotes) followed by
  65. <ENTER>.  The results are identical. 
  66.  
  67. NOTE:     PNTRCODE is not designed to accept HEX codes.  One-
  68. character codes followed by <ENTER> will be accepted as ASCII
  69. characters.  That is "e" will result in an ASCII code of 101 and
  70. a hex code of 65.  "2" will result in an ASCII code of 50 and a
  71. hex code of 32.  2 or 3 character codes will be accepted as ASCII
  72. codes.  "65" will be accepted as character "A" and hex code 41. 
  73. An alpha character (i.e. - a,X,Q, etc) will NOT be accepted as
  74. part of a 2 or 3 character code.  If a single digit ASCII code is
  75. required, such as "7" ( to code a "BEEP") it must be entered as
  76. "007" (07 is likewise acceptable).
  77.  
  78.      Continuing on with the example, the next code "B" can be
  79. selected by typing "B" (without quotes) followed by <ENTER> or by
  80. typing its ASCII code "066" followed by <ENTER>.  Similarly "5"
  81. can be selected by typing "5" <ENTER> or by its ASCII code "053"
  82. <ENTER>.  Be careful when entering numerics as codes.  Sometimes
  83. manuals are not too clear on whether character 1, ASCII code 049
  84. or ASCII code 001, the "smiling face" character is required.  To
  85. help alleviate this problem PNTRCODE displays the character if
  86. possible, the hex code and the ASCII code so that proper coding
  87. can be verified.  Also be aware the 1 (one) and l (ell) and also
  88. 0 (zero) and O (capital oh) can be misread easily.
  89.  
  90.      When the code sequence is complete, terminate the process by
  91. an <ENTER> without any data.  The screen will clear and the DOS
  92. prompt will return.  Normally two error messages, typically "File
  93. not found" and "Batch file missing" may be seen but these
  94. messages are normal and a part of the _.COM generation process. 
  95. Now display the directory and the desired _.COM file will be
  96. listed (LEFTMARG.COM in this example).
  97.  
  98.      This particular _.COM file could be checked as follows: 
  99. Generate a printout with normal setting by typing at the DOS
  100. prompt "DIR >PRN" <ENTER>.  This will print out the default
  101. directory.  Then type "LEFTMARG" <ENTER> to set the printer. 
  102. Then repeat "DIR >PRN" <ENTER>.  That printout will be identical
  103. except the new margin will be apparent.
  104.  
  105. NOTE:     Most programs automatically reset the printer before
  106. any printer output is produced.  If the software does reset the
  107. printer, any printer commands issued by the _.COM file before the
  108. program was run will be erased.  PNTRCODE is useful primarily for
  109. printing ASCII text using DOS commands, although in some cases
  110. the _.COM file may be of use when running software that normally
  111. produces a printed output.  It all depends upon the software
  112. program and how the printer is setup within that software.
  113.  
  114.      An ideal first trial run for PNTRCODE may be to generate a
  115. RESET command (PRNRESET.COM, maybe) that can be used to return
  116. the printer to the reset condition after printer codes for
  117. special features have been issued.  The proper reset code can be
  118. found in the printer manual.
  119.  
  120.                      DISCLAIMERS, ETC
  121.  
  122.      PNTRCODE is freely released to all interested parties. 
  123. There is no requirement or plea to register or license the
  124. program.  Similarly there is no guarantee, warranty or implied
  125. responsibility by the author for this program and its use.  So
  126. take PNTRCODE and try it.  If you like it, a donation of $5 to
  127. the author would be much appreciated, a small reward for the
  128. efforts to develop this user-friendly program from an earlier
  129. very un-friendly concept.
  130.  
  131.                               Regards
  132.  
  133.                           FRED HARTMAN
  134.                    "Ready Freddie's Utilities"
  135.                      5677 High Meadow Drive
  136.                        Norcross, GA  30092
  137.  
  138.                                                   August 15, 1992
  139.  
  140.